home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / status25.zip / STATUS.DOC < prev    next >
Text File  |  1993-01-09  |  16KB  |  345 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                    Network Mail Status (Postlink Software Version)
  8.           =================================================================
  9.  
  10.                First  off I  would like  to thank  those users  who offered
  11.           suggestions  and  made comments.  Some functions/diplays  are the
  12.           result of this imput.
  13.  
  14.                This program generates a network import mail status bulletin
  15.           showing  each conference, 1000  maximum, and the  total number of
  16.           messages imported for  current date  and total to  date for  each
  17.           conferences,  the last import date and the total messages to date
  18.           for the  specified network.  Also generates last  import bulletin
  19.           showing imported current date as well as total to date.
  20.  
  21.                It also generates a network export mail status bulletin with
  22.           the  same format as the  above import bulletin.  Since the export
  23.           routine  contains all  conference names  it is  run first  to get
  24.           those names  so  that conferences  with  zero imports  are  still
  25.           displayed in the import bulletin. I could not find another way to
  26.           get all conference names.
  27.  
  28.                Supports  multiple  networks. This  program  uses Postlink's
  29.           export / import log(s). It does a monthly rollover of the  LOG(s)
  30.           using  PKZIP.EXE.  There  is   an  eighteen  character  limit  on
  31.           conference names, names longer than that are truncated.
  32.  
  33.                Starting with version 2.4 there are major changes in the way
  34.           the program runs. Command line parameters have changed once again
  35.           and options are now  in a nine line configuration  file. Requires
  36.           registration to remove "Unregistered BBS" from bulletins.
  37.  
  38.  
  39.                This archive should contain the following files:
  40.  
  41.                STATUS.EXE............ Actual program
  42.                STATUS.DOC............ This file
  43.                STATUS.CFG............ Sample configuration file     
  44.                STATUS2.CFG........... Sample configuration file
  45.                STATUS3.CFG........... Sample configuration file
  46.                READ.ME............... Update/changes information
  47.                STATUS.BAT............ Sample batch file
  48.                FILE_ID.DIZ........... BBS description file
  49.                SUPPORT.TXT........... Location of Support BBS
  50.  
  51.  
  52.  
  53.  
  54.  
  55.                Syntax is pretty straight forward:
  56.  
  57.                                   STATUS STATUS.CFG
  58.  
  59.                "STATUS.CFG" and be the name of any configuration  file with
  60.           the following format:
  61.  
  62.                          (1) Unregistered BBS
  63.                          (2) 0000
  64.                          (3) Postlink
  65.                          (4) C:\POST1.LOG
  66.                          (5) C:\BLT7
  67.                          (6) C:\POST2.LOG
  68.                          (7) C:\BLT77
  69.                          (8) C:\BLT777
  70.                          (9) PCB
  71.  
  72.                                      .CFG line #1
  73.  
  74.                "Unregistered BBS", system name if registered
  75.  
  76.                                      .CFG line #2
  77.  
  78.                "0000" serial number if registered.
  79.  
  80.                                      .CFG line #3
  81.  
  82.                "Postlink"  should be the name of the actual network you are
  83.           using,  one word  and case  sensitive. 18 characters  max, longer
  84.           names are  truncated. Say  you are  making two  different network
  85.           mail runs with the same software, you would use those names here,
  86.           each in it's own configuration file.
  87.            
  88.                                      .CFG line #4
  89.  
  90.                "C:\POST1.LOG" is the path and name of  your Postlink Export
  91.           log.  Lines #4  and #6  can contain  the same  file name  if your
  92.           Export and Import logs are in one file.
  93.  
  94.                                      .CFG line #5
  95.  
  96.                "C:\BLT7" is the path and name for your Export bulletin.
  97.  
  98.                                      .CFG line #6
  99.  
  100.                "C:\POST2.LOG" is the path and name of your Postlink  Import
  101.           log.  Lines #4  and #6  can contain  the same  file name  if your
  102.           Export and Import logs are in one file.
  103.  
  104.                                      .CFG line #7
  105.  
  106.                "C:\BLT77" is the path and name for your Import bulletin.
  107.  
  108.  
  109.  
  110.  
  111.  
  112.                                      .CFG line #8
  113.  
  114.                "C:\BLT777"  is  the path  and  name  for your  Last  Import
  115.           bulletin.
  116.  
  117.                                      .CFG line #9
  118.  
  119.                Color  and characters used are  as follows and  are setup to
  120.           give the sysop  as much control over the output  as possible. Not
  121.           all  users can  read and handle  IBM extended  graphic characters
  122.           (like sight impaired users  and voice hardware). Program can  use
  123.           either "=/-" or IBM's extended  graphic characters "═/─". Line #9
  124.           should contain one of the following options:
  125.  
  126.                "PCB" use IBM extended  graphic characters and PCBoard's @X0
  127.           colorizing codes.
  128.  
  129.                "PCB0" use no IBM  extended graphic characters and PCBoard's
  130.           @X0 colorizing codes.
  131.  
  132.                "ANSI"  use   colorizing   and  no   IBM  extended   graphic
  133.           characters.
  134.  
  135.                "ANSI2" use colorizing and IBM extended graphic characters.
  136.  
  137.                "ASCII"  use  no  colorizing  and no  IBM  extended  graphic
  138.           characters.
  139.  
  140.                "ASCII2"  use   no  colorizing  and  IBM   extended  graphic
  141.           characters.
  142.  
  143.  
  144.  
  145.  
  146.  
  147.                          PKZIP.EXE used by the Status Program
  148.  
  149.                "PKZIP.EXE" must be somewhere in your path or in the current
  150.           directory. When  the month  changes in the  export/import.log the
  151.           program  archives the  current log  into a  file using  'ML'+ the
  152.           current date  (ML010193.ZIP, etc.). It also  includes the current
  153.           logs  (1 or  2), all three  bulletins, and  writes it  out to the
  154.           directory that contains  the log file. The  program then rewrites
  155.           the log using  only the current new month's data.  This way there
  156.           is  only  one  month's log  data  in  your  Postlink log(s).  The
  157.           bulletins are added to the archive so that sysops  wanting to see
  158.           totals would have the  last ones generated prior to  the rollover
  159.           without having to do so manually.
  160.  
  161.                If you do not want the previous month's log(s) simply delete
  162.           the archive from your hard drive. In your  calling batch file you
  163.           can  add "IF EXIST ML*.ZIP DEL ML*.ZIP" and this will auto-delete
  164.           the  archive. If there  are no imported/export4r  messages on the
  165.           day of the rollover then a bulletin reflecting same is generated.
  166.           There must be at least one meg of free disk space for the archive
  167.           to be executed. I have  no idea the possible sizes and  if anyone
  168.           has problems with the archive with one meg as  the minimum please
  169.           let  me know  and I  will  increase the  size of  the free  space
  170.           needed.
  171.  
  172.                It should be noted that when  you start using Status if your
  173.           Postlink log(s) are not  the current month's logs that  they will
  174.           not roll over until the month rolls over inside the log. Say your
  175.           log(s) are dated 01-15-93 and you start using Status in 02-93, no
  176.           messages since  01-15-93, the  log will  still show  the messages
  177.           imported up till 01-15-93.  If your log contains  multiple months
  178.           of  logs when it rolls  them over you  will only end  up with the
  179.           previous month's log, the  others will have been over  written by
  180.           the  last one in the archive. Either  that or you can archive the
  181.           log(s) and delete everything  up to the current month  before you
  182.           run Status for the first time.
  183.  
  184.                If  you are making two  or more DIFFERENT  network mail runs
  185.           the  only thing  you  must  do  is make  two  or  more  different
  186.           POSTLINK.CFG  files, one with the  name of the  LOG file for each
  187.           network so that ALL logs are not put into  one file. I would have
  188.           no way of  knowing what messages came from what  network in order
  189.           to separate them. You would then just have a TEMP1.CFG, TEMP2.CFG
  190.           and when you call postlink  you just copy TEMP1.CFG POSTLINK.CFG,
  191.           then on next run you might copy TEMP2.CFG POSTLINK.CFG, etc.
  192.  
  193.                A simple batch file might look like one of these:
  194.  
  195.                     CD \POSTLINK
  196.                     COPY TEMP1.CFG POSTLINK.CFG
  197.                     POSTLINK CALLER.CFG
  198.                     STATUS STATUS.CFG
  199.  
  200.  
  201.  
  202.  
  203.  
  204.                     CD \POSTLINK
  205.                     Copy TEMP2.CFG POSTLINK.CFG
  206.                     POSTLINK CALLER2.CFG
  207.                     STATUS STATUS2.CFG
  208.  
  209.                Perhaps you want  to make  a bulletin with  the PCBoard  @X0
  210.           codes  and one using straight  ASCII codes and  yet another using
  211.           ANSI codes. The .CFG  files would contain the bulletin  names and
  212.           the form setting (#9):
  213.  
  214.                STATUS STATUS.CFG
  215.                (.CFG with PCB, uses ANSI codes and IBM extended graphic
  216.                 characters)
  217.  
  218.                STATUS STATUS2.CFG
  219.                (.CFG with ASCII, ASCII and no IBM extended graphic
  220.                 characters)
  221.  
  222.                STATUS STATUS3.CFG
  223.                (.CFG with ANSI, ANSI colors and no IBM extended graphic
  224.                 characters)
  225.  
  226.                You just call  STATUS as many times as  needed, with as many
  227.           .CFG files as needed,  to generate whatever formats you  want. On
  228.           my 386/33 it takes less than twenty seconds to run the program on
  229.           a 6,500 line test log (from three BBS systems).
  230.  
  231.  
  232.  
  233.  
  234.  
  235.                If you don't like the program please write to me and explain
  236.           why. Send  me any suggestions you might have. If they enhance the
  237.           overall program I will try to incorporate part, some, all, in the
  238.           next release.
  239.  
  240.                Current versions (01-04-93) of James  Huckabey door/Postlink
  241.           programs.  The doors are Door Patch 3.8 doors and now support the
  242.           following  BBS drop  files:  DOOR.SYS, PCBOARD.SYS,  SFDOORS.DAT,
  243.           CALLINFO.BBS, DORINFO1.DEF, DORINFO2.DEF and CHAIN.TXT. Converter
  244.           needed for other  BBS software. Current  releases also reflect  a
  245.           reduction in registration fees.  Send me a diskette covering  one
  246.           meg, with  return postage, and I will return it with all my doors
  247.           and Postlink  software on it/them and as any of my other software
  248.           programs that might fit in any free space.
  249.  
  250.           BBS Doors:
  251.  
  252.           BK14-400 ZIP  Book Review door
  253.           BR14-300 ZIP  BBS Review door
  254.           CS14-500 ZIP  Community Service door
  255.           DR14-300 ZIP  BBS Door Review door
  256.           GO14-400 ZIP  Gotcha game door (enhanced)
  257.           GTPL-400 ZIP  GT Power List door for GT Power BBS
  258.           MR14-300 ZIP  Music Review door
  259.           MV14-300 ZIP  Movie View door
  260.           PCOVE501 ZIP  Pirate's Cove game door (all new release)
  261.           RR14-400 ZIP  Restaurant Review door
  262.           TRLD-901 ZIP  The Rime List Door (name change from PCRL)
  263.           SW14-600 ZIP  Software Review door
  264.           WR14-300 ZIP  Wine Review door
  265.  
  266.           Postlink:
  267.  
  268.           LT100392 ZIP  Lasttime, Generates bulletin when successful
  269.                         Postlink mail transfer. Supports ASCII, ANSI and
  270.                         PCBoard codes. Freeware! (not a door). Filename is
  271.                         compile date.
  272.           STATUS24 ZIP  Generates Postlink bulletin showing total messages
  273.                         to date for each conference, total conferences,
  274.                         total messages, and monthly rollover. Optional last
  275.                         import mail transfer bulletin. Supports straight
  276.                         ASCII, ANSI and PCBoard colorizing.                                      Registration
  277.  
  278.                If  you find this program useful please send BBS information
  279.           and one of the following in U.S. funds only:
  280.  
  281.                Registration only.................................. $10
  282.                (outside U.S. please add $2)
  283.  
  284.                Registration and latest version.................... $12
  285.                (outside U.S. please add $3) Include diskette size.
  286.  
  287.                 I  had  expected support  without  having  to  resort to  a
  288.           registration  system, but of course  I was wrong.  I just put too
  289.           much time and  effort into this program to release it as freeware
  290.           like  I did my  Lasttime program. The  program package represents
  291.           many  long  hours  of  programming, testing,  updating  and  more
  292.           testing,  as well  as  LD telephone  calls  to get  it tested  or
  293.           distribute the beta and release copies. Please support my efforts
  294.           and register your copy.
  295.  
  296.           FROM: 
  297.                   Name: 
  298.                        ---------------------------------------------------
  299.                Address:  
  300.                        ---------------------------------------------------
  301.                   City: 
  302.                        ---------------------------------------------------
  303.            State & Zip: 
  304.                        ---------------------------------------------------
  305.                 HUB ID:                       NODE ID:
  306.                        ----------------------         --------------------
  307.           Phone(voice):                        (data)
  308.                        ---------------------         ---------------------
  309.  
  310.           Diskette type if registration includes current version
  311.                                            (360, 1.2, 720, 1.44) ---------
  312.  
  313.           Version number you have if registration includes current version.
  314.           If  you have  current version  your version  request fee  will be
  315.           returned. 
  316.                                                                  ---------
  317.  
  318.              Please  supply name  of BBS  to be  added to  program. It  may
  319.           include other data up  to sixty characters. Anything longer  than
  320.           that will  be truncated, no exceptions. This is to be on one line
  321.           of  code and must be legible since  the serial number is based on
  322.           exact syntax. I cannot be responsible for unreadable data. Please
  323.           print. Case sensitive!
  324.  
  325.           Example:  "Jim's  Graphic BBS".  In Status  it  comes out  as the
  326.           following in all bulletins generated (example is  no IBM extended
  327.           graphic characters):
  328.  
  329.                ==================:Jim's Graphic BBS:==================
  330.  
  331.  
  332.           ----------------------------------------------------------------                Your registration number, and diskette if requesting current
  333.           version, are be sent by return mail.
  334.  
  335.                     James Huckabey
  336.                     3621-A Fraser Street
  337.                     Bellingham, Washington 98226 U.S.A.
  338.                     (206) 671-2868 (voice) I do have a USR 14.4 DS!
  339.  
  340.                You can also contact me at:
  341.  
  342.                     Corporate Headquarters BBS
  343.                     Sysop: Bob Neal
  344.                     RelayNet (tm): CHQBBS (#1255)
  345.                     (815) 886-3233 / (815) 886-9381 (14400 V32bis)